E' il widget di selezione di uno o più elementi a partire da una lista di dati dinamicamente precaricata. La collezione dei dati che compongono l'insieme selezionabile solitamente viene desunta da una struttura dati, i cui elementi devono essere specificatamente indicati.
Quando il controllo non è attivo mostra solo un valore (corrispondente al contenuto memorizzato nel campo all'ultima scelta effettuata); una volta attivato mostra tutta la lista dei possibili valori.
Il widget completo prevede una label ed il campo di selezione associato.
La label può essere, in casi particolari, vuota.
Alla selezione di un elemento dalla lista viene eseguita la logica applicativa associata.
| cod. | nome | descrizione |
|---|---|---|
| apparenza grafica | ||
| WCMB010 | marcatore errore di validazione | Visualizzazione di un marcatore di errore in prossimità della label, in caso di fallita validazione (rif. Label ) |
| WCMB011 | evidenza obbligatorietà | Evidenza di obbligatorietà (es. Asterisco a lato della label) (rif. Label ) |
| WCMB013 | scrolling delle voci | Modalità di visualizzazione di dati che eccedono la dimensione visibile (es. scroll del contenuto mantenendo fissa la dimensione grafica o troncamento del testo) |
| WCMB015 | tooltip a comparsa | Comparsa del tooltip al passaggio del cursore sulla label (rif. Tooltip ) |
| WCMB018 | evidenza stato abilitazione | Evidenza dello stato di abilitazione (es. differente colore della label in stato editabile rispetto a non editabile) (rif. Label ) |
| WCMB020 | num. linee visibili in multiselezione | Nel caso di ComboBox a selezione multipla è possibile definire a tempo di progettazione il numero di linee che devono essere visualzzate senza che si debba utilizzare la scrollbar. |
| WCMB021 | label | Il widget è tipicamente corredato da una etichetta testuale che permette di identificarlo all'interno della schermata. In genere il testo (o una eventuale immagine) sono scelti in modo da descrivere il contenuto informativo del widget. In alcuni casi particolari l'etichetta potrebbe essere assente. (rif. Label ) |
| dinamica di interazione | ||
| WCMB006 | abilitazione comandabile | Disabilitazione/Abilitazione a comando |
| WCMB007 | visibilità a comando | Modalità invisibile/visibile a comando |
| WCMB008 | profilazione dell'abilitazione | Disabilitazione/Abilitazione a fronte di regole associate al profilo dell'utente collegato |
| WCMB009 | profilazione della visibilità | Modalità invisibile/visibile a fronte di regole associate al profilo dell'utente collegato |
| WCMB012 | copy | Possibilità di copiare nella clipboard il testo descrittivo dell'opzione correntemente selezionata |
| WCMB014 | autocomplete | Funzione di autocomplete (restrizione dell'elenco di opzioni a fronte dell'immissione progressiva dei caratteri iniziali della selezione stessa) |
| WCMB016 | attivazione logica alla selezione | Attivazione logica applicativa associata a fronte della selezione di un elemento |
| WCMB019 | suggestion | utilizzo suggestion (rif. Suggestion ) |
| struttura | ||
| WCMB017 | includibilità in pannelli | Il ComboBox può essere contenuto nei seguenti pannelli:
|
| dati | ||
| WCMB001 | ordinamento predefinito dati | Ordinamento di visualizzazione desiderato (es.: alfabetico, su codice identificativo,...) |
| WCMB002 | selezione singola | Utilizzo della combo in selezione singola |
| WCMB003 | selezione multipla | Utilizzo della combo in selezione multipla |
| WCMB004 | selezione valore iniziale | Preselezione di una voce della lista (default) (es. alla visualizzazione della schermata) |
| WCMB005 | validazione al submit | Validazione della selezione al submit della form (rif. Submit (di una form) ) |
|
| combobox obbligatorie |
|
| combobox con marcatore errore |
|
| combobox con autocomplete |
|
| combobox condizionata |
Nella tabella seguente è riportato il grado di implementazione delle varie caratteristiche/funzioni dell'elemento ComboBox nelle differenti implementazioni.
| cod | feature | guigen | |||
|---|---|---|---|---|---|
| 1.5.0 | 1.6.0 | ||||
| neutral-base | neutral-arricchita | neutral-base | neutral-arricchita | ||
| apparenza grafica | |||||
| WCMB010 | marcatore errore di validazione | ![]() |
![]() |
![]() |
![]() |
| WCMB011 | evidenza obbligatorietà | ![]() |
![]() |
![]() |
![]() |
| WCMB013 | scrolling delle voci | ![]() |
![]() |
![]() |
![]() |
| WCMB015 | tooltip a comparsa | ![]() |
![]() |
![]() |
![]() |
| WCMB018 | evidenza stato abilitazione | ![]() |
![]() |
![]() |
![]() |
| WCMB020 | num. linee visibili in multiselezione | ![]() |
![]() |
![]() |
![]() |
| WCMB021 | label | ![]() |
![]() |
![]() |
![]() |
| dinamica di interazione | |||||
| WCMB006 | abilitazione comandabile | ![]() |
![]() |
![]() |
![]() |
| WCMB007 | visibilità a comando | ![]() |
![]() |
![]() |
![]() |
| WCMB008 | profilazione dell'abilitazione | ![]() |
![]() |
![]() |
![]() |
| WCMB009 | profilazione della visibilità | ![]() |
![]() |
![]() |
![]() |
| WCMB012 | copy | ![]() |
![]() |
![]() |
![]() |
| WCMB014 | autocomplete | ![]() |
![]() |
![]() |
![]() |
| WCMB016 | attivazione logica alla selezione | ![]() |
![]() |
![]() |
![]() |
| WCMB019 | suggestion | ![]() |
![]() |
![]() |
![]() |
| struttura | |||||
| WCMB017 | includibilità in pannelli | ![]() |
![]() |
![]() |
![]() |
| dati | |||||
| WCMB001 | ordinamento predefinito dati | ![]() |
![]() |
![]() |
![]() |
| WCMB002 | selezione singola | ![]() |
![]() |
![]() |
![]() |
| WCMB003 | selezione multipla | ![]() |
![]() |
![]() |
![]() |
| WCMB004 | selezione valore iniziale | ![]() |
![]() |
![]() |
![]() |
| WCMB005 | validazione al submit | ![]() |
![]() |
![]() |
![]() |